home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / stack_18.zip / ST!SYSOP.DOC < prev    next >
Text File  |  1992-01-09  |  12KB  |  280 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                        S t a c k ' E m !                       /
  4.     /                           Version 1.8                          /
  5.     /                                                                /
  6.     /                        (c) Copyright 1992                      /
  7.     /                          J & W Software                        /
  8.     /                                                                /
  9.     /                                                                /
  10.     /       DOOR game for Wildcat!, PCBoard 14.x, RA/QBBS, GAP,      /
  11.     /       SPITFIRE  and  other BBS  software which  uses door      /
  12.     /       information files compatible with the above.             /
  13.     /                                                                /
  14.     /                                                                /
  15.     /                           Support BBS:                         /
  16.     /                          Gulf Coast BBS                        /
  17.     /                          (904) 563-2547                        /
  18.     /                         1200 - 14400 HST                       /
  19.     //////////////////////////////////////////////////////////////////
  20.  
  21.  
  22.     INTRODUCTION
  23.     ------------
  24.  
  25.     Stack'Em! is  a game where the player has to join different shaped
  26.     falling  pieces  together  to  form  completed  horizontal  lines.
  27.     Scoring is based on how many pieces are played and number of lines
  28.     completed.  Players  compete for weekly high  score as well as All
  29.     Time High Scorer.
  30.  
  31.  
  32.     FEATURES
  33.     --------
  34.  
  35.     - ANSI Color and Mono screens with animation
  36.     - Full multi-node support
  37.     - Support for locked DTE up to 38.4K bps
  38.     - Support for non-standard COM3 and COM4 ports
  39.     - DESQview aware
  40.     - Easy installation and no maintenance
  41.  
  42.  
  43.     SETUP
  44.     -----
  45.  
  46.     Setup  is  very simple.  Create a directory and  place  the  files 
  47.     STACKEM.EXE and ST!SETUP.EXE in this directory.
  48.  
  49.     Change to this directory and run ST!SETUP.  A screen with  several
  50.     fields  will be displayed.  There will be a box at the  bottom  of 
  51.     the  screen that will  display  help  information for each  field.
  52.     The  following  edit keys  are allowed: HOME, END, BACKSPACE, LEFT
  53.     and RIGHT ARROW. Use the ENTER,  UP  and  DOWN  ARROW keys to move
  54.     between the different fields.
  55.  
  56.     Each field is described below:
  57.  
  58.     Name: The name of the person registering the program as it will be
  59.     displayed on  the opening screen (when registered).  This does not
  60.     necessarily have  to  be the SysOp, it could be the name of a user
  61.     who donated the registration fee.
  62.  
  63.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  64.     opening screen (when registered).
  65.  
  66.     Key Number:  If registered, enter your Key Number here.  Until the
  67.     program  is registered leave this field  as  all zeroes.   See the
  68.     registration section below for more information about registering.
  69.  
  70.     Allowable plays per day:  The number of plays per day that will be
  71.     allowed.  Zero (00) means unlimited plays per day.
  72.  
  73.     Display 'Next Piece' [Y/N]:  If 'Y', the next piece  to  be played
  74.     will be displayed to the player.
  75.  
  76.     Use the  'Doughnut'  piece [Y/N]:  If 'Y',  the  large  'Doughnut'
  77.     shaped piece will be used.  You may not want to use the 'Doughnut'
  78.     shaped piece if small children will be playing the game.
  79.  
  80.                                    Doughnut
  81.  
  82.                                     ██████
  83.                                     ██  ██
  84.                                     ██████
  85.  
  86.  
  87.  
  88.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  89.     bulletin file. If left blank no file will be written.
  90.  
  91.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  92.     Color) bulletin file.  If left blank no file will be written.
  93.  
  94.     COM3 (Base Address and IRQ):  If installed  enter the Base Address
  95.     in Hex (e.g. 03E8) and IRQ of COM3.
  96.  
  97.     COM4 (Base Address and IRQ):  If installed  enter the Base Address
  98.     in Hex (e.g. 02E8) and IRQ of COM4.
  99.  
  100.     After entering all of the information, press 'ESC'.  ST!SETUP will
  101.     ask if you want  to save the configuration  file.   If this is the
  102.     first  time  ST!SETUP  has been  run  or  you  have previously run
  103.     ST!SETUP  but  changed some of the information, press  'Y'.   This
  104.     will  create or update the configuration file  (STACKEM.CFG).   It
  105.     will also create a STACKEM.SCO file if one does not exist. This is
  106.     the score file and is needed for the program to run.
  107.  
  108.     ST!SETUP will then ask if you want to create the registration file
  109.     (STACKEM.REG).   The  registration  file will be needed  when  the
  110.     program is registered, so you will need to answer 'Y' at least one
  111.     time for this file to be created.  Please be sure all  information 
  112.     is correct as your 'Key Number' will be based on this information.
  113.  
  114.     Consult  your  BBS manual for how to create DOOR batch  files  for 
  115.     your  BBS.   STACKEM.EXE must  be started from  the  directory  it
  116.     resides in for the game to function.  The command line for calling 
  117.     Stack'Em! is as follows:
  118.  
  119.     STACKEM STACKEM.CFG 'Full path and name of BBS information file'
  120.  
  121.     'Full path and name of BBS information file'
  122.  
  123.     This  will be the full path and filename of your  BBS  information 
  124.     file.   For  example:  C:\PCB\PCBOARD.SYS.   Stack'Em!  uses  this
  125.     filename  to  determine the BBS software which is  being  used  as 
  126.     follows:
  127.  
  128.     CALLINFO.BBS (Wildcat 2.xx)
  129.     PCBOARD.SYS  (PCBoard)
  130.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  131.     SFDOORS.DAT  (SPITFIRE)
  132.     DORINFOx.DEF (RA/QBBS)
  133.  
  134.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not 
  135.     compatible with RBBS.
  136.  
  137.     An example of a batch file for PCBoard:
  138.  
  139.     CD\STACK
  140.     STACKEM STACKEM.CFG C:\PCB\PCBOARD.SYS
  141.     CD\PCB
  142.     BOARD.BAT
  143.  
  144.  
  145.     UPGRADING
  146.     ---------
  147.  
  148.     To upgrade from versions  1.5+,  replace the old  STACKEM.EXE  and
  149.     ST!SETUP.EXE  files  with  the  new  version  1.8  STACKEM.EXE and
  150.     ST!SETUP.EXE files.
  151.  
  152.     To upgrade from earlier versions follow these steps:
  153.  
  154.     1 - Replace the existing STACKEM.EXE with the new STACKEM.EXE.
  155.     2 - Delete your existing STACKEM.CFG.
  156.     3 - Delete your existing STACKEM.SCO.
  157.     4 - Run ST!SETUP to create the new STACKEM.CFG.
  158.     5 - Modify your batch file(s) for the new command line syntax.
  159.  
  160.     Multiple  configuration files are no longer necessary  if  running 
  161.     multi-node.
  162.  
  163.  
  164.     ERRORS
  165.     ------
  166.  
  167.     Any  errors  which may occur  will be written to  the  STACKEM.ERR
  168.     file.  When possible, a descriptive error message will be  written 
  169.     to  STACKEM.ERR  with the exact cause of the error.  If the  error
  170.     cannot be resolved, call the support BBS (Gulf Coast BBS) and give 
  171.     the exact text of the error message in STACKEM.ERR.   All  support
  172.     is handled through the Gulf Coast BBS.
  173.  
  174.  
  175.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  176.     ------------------------------------
  177.  
  178.     Stack'Em! v1.8 has been developed in a networked environment.  All
  179.     multi-node features have been thoroughly tested on multi-node sys-
  180.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  181.     full record and file locking is supported.  Multiple configuration
  182.     files are NOT necessary when running on multi-node systems.
  183.         
  184.     Stack'Em! v1.8  is DESQview  aware.  It is automatically detected,
  185.     screen and  keyboard I/O are  "well behaved",  and time slices are
  186.     given back to other applications where appropriate. Stack'Em! v1.8
  187.     has been tested with 3 nodes running simultaneously under DESQview
  188.     (all ports  locked at  38400)  with no  noticeable effect on other
  189.     nodes.
  190.  
  191.  
  192.     MISCELLANEOUS
  193.     -------------
  194.  
  195.     At the  beginning of  each week the score  file will automatically
  196.     be cleared and last week's high scorer will be determined.
  197.  
  198.     If you are using a high speed modem and have your com port LOCKED, 
  199.     the  program will not respond to keyboard input while  your  modem 
  200.     buffer is full.  This is normal.
  201.  
  202.     Stack'Em! may be played from the DOS prompt by typing:
  203.  
  204.     STACKEM STACKEM.CFG LOCAL
  205.  
  206.     Note the user name is hard coded as 'SysOp' and the bulletins  and
  207.     score file will not be updated. Also, play will not be limited  to
  208.     the allowable plays per day set in ST!SETUP. This mode is only for
  209.     testing.
  210.  
  211.     To turn on screen writing, if it is off, press any key.
  212.  
  213.  
  214.     REGISTRATION
  215.     ------------
  216.  
  217.     Registration is required if you choose to continue using this DOOR 
  218.     program.   After 60 days of running the program unregistered,  the 
  219.     score  file  will  cease to be updated.  However,  the  game  will 
  220.     continue  to allow players to play. This should be long enough  to 
  221.     determine if the program meets your needs and is popular with your 
  222.     users.
  223.  
  224.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  225.     with a 'Registered To:' message.  This will show the Name and  BBS 
  226.     Name from the STACKEM.CFG file.
  227.  
  228.     There are two ways to register.
  229.  
  230.                         * Mail order Registration *
  231.  
  232.     If the STACKEM.REG form was not  previously  created, run ST!SETUP
  233.     and have  it  create STACKEM.REG.  Check this  file to  insure the
  234.     information is correct. If it is not, re-run  ST!SETUP and correct
  235.     any errors.   Your Key Number is based on the information in  this
  236.     file  and must be correct for your Key Number to work.  When done,
  237.     print the form  to your printer.  Send the  completed  STACKEM.REG
  238.     form  along  with your  check,  money order,  VISA,  MasterCard or
  239.     Discover credit card information for $15.00 (US) to:
  240.  
  241.                               J & W Software
  242.                           9426 N. China Pink Way
  243.                       Crystal River, FL  32629-9500
  244.  
  245.     Your personalized Key Number will be sent to you promptly. When it
  246.     is received, run ST!SETUP  and  enter the  number.  Stack'Em! will
  247.     then be registered.  No other action is necessary.
  248.  
  249.  
  250.                      * Instant On-Line Registration *
  251.  
  252.     You may register  Stack'Em! with  VISA, MasterCard or Discover and
  253.     receive your personalized Key Number instantly by calling the Gulf
  254.     Coast BBS, (904) 563-2547,  and entering REGISTER at the main menu
  255.     prompt.  You  will need the  Name  and  BBS Name  exactly as it is
  256.     entered on  lines 1 & 2  of  ST!SETUP as well as  your credit card
  257.     information to  register.  You  might  want  to make  note of this
  258.     information to speed  your call.  You will receive your Key Number
  259.     on that call.
  260.  
  261.  
  262.     WARRANTY & DISCLAIMER
  263.     ---------------------
  264.  
  265.     There  are  no warranties, express or  implied,  for  unregistered 
  266.     copies of Stack'Em!.  The author will  NOT  be held liable for any
  267.     direct,  indirect, incidental, or consequential  damage  resulting 
  268.     from  the  use  of  this  program.   Your  use  of  this   program 
  269.     constitutes your AGREEMENT to this disclaimer and your release  of 
  270.     the author from any form of liability.
  271.  
  272.     Registered  copies  of  Stack'Em!  are  warranted  to  perform  as
  273.     described  in this  documentation.  In the  event  Stack'Em!  does
  274.     not  perform as described, the author will elect to either rectify
  275.     the  problem or refund  the amount  paid, provided notification is
  276.     received within 30 days of registration.
  277.  
  278.  
  279.                                  - END -
  280.